home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 May: Tool Chest / Developer CD Series Tool Chest (Apple Computer)(May 1999).iso / Tool Chest / Networking / SNMP / AppleTalk SW for SNMP / AppleTalk Administration 1.0.2 / Mac System MIB < prev    next >
Encoding:
Text File  |  1993-06-15  |  26.4 KB  |  1,020 lines  |  [TEXT/ttxt]
  1. M.Ritter/G.Holzhauer 
  2.  
  3. Apple IP Working Group     Apple Computer, Inc. 
  4.  
  5. Macintosh System Management Information Base
  6.  
  7. Version 1.0.2 , April 7th, 1993
  8.  
  9. Status of this memo
  10.  
  11. This document is an Internet Draft. Internet Drafts are working 
  12. documents of the Internet Engineering Task Force (IETF), its Areas, and its 
  13. Working Groups. Note that other groups may also distribute working 
  14. documents as Internet Drafts.
  15.  
  16. Internet Drafts are draft documents valid for a maximum of six 
  17. months. Internet Drafts may be updated, replaced, or obsoleted by other 
  18. documents at any time. It is not appropriate to use Internet Drafts as 
  19. reference material or to cite them other than as a "working draft" or "work 
  20. in progress."
  21.  
  22. Please check the I-D abstract listing contained in each Internet 
  23. Draft directory to learn the current status of this or any other Internet 
  24. Draft.
  25.  
  26. This draft document will be submitted as an informational RFC 
  27. describing an enterprise-specific extension to the SNMP MIB. Distribution 
  28. of this memo is unlimited. Please send comments to the author.
  29.  
  30. Table of Contents
  31.  
  32. 1. Abstract........................................................1
  33. 2. Historical perspective..........................................2
  34. 3. Objects.........................................................2
  35. 4. Overview........................................................2
  36. 4.1 Structure of the Macintosh MIB.................................2
  37. 4.2 The System Group...............................................3
  38. 4.3 The Software Group.............................................3
  39. 4.4 The Hardware Group.............................................3
  40. 5. Textual conventions.............................................3
  41. 6. Definitions.....................................................4
  42. 7. Acknowledgments.................................................18
  43. 8. References......................................................19
  44. 9. Author's address................................................20
  45.  
  46.  
  47. 1. Abstract
  48.       
  49. This memo defines an enterprise-specific portion of the Management
  50. Information Base (MIB) [1] for use with the Simple Network Management
  51. Protocol (SNMP) [3]. In particular, it defines objects for managing
  52. Macintosh computers.  
  53.  
  54.  
  55. 2. Historical Perspective
  56.  
  57. Consistent with the Internet Activities Board directive to produce simple, 
  58. workable systems in the short term, the list of managed objects defined in 
  59. the Internet-standard MIB [2] was derived by taking only those elements 
  60. that were considered essential. However, the SMI [1] defined three 
  61. extensibility mechanisms: one, the addition of new standard objects through 
  62. the definitions of new versions of the MIB; two, the addition of widely 
  63. available but nonstandard objects through the experimental subtree; and 
  64. three, the addition of private objects through the enterprises subtree. 
  65. Such additional objects can be used not only for vendor-specific elements, 
  66. but also for experimentation as required to further the knowledge of which 
  67. other objects are essential.
  68.  
  69. This memo defines extensions to the MIB using the third method. It contains 
  70. definitions of managed objects specific to one enterprise.
  71.  
  72.  
  73. 3. Objects
  74.  
  75. Section 6 contains the specification of all object types contained in this 
  76. MIB module. The object types are defined using the conventions defined in 
  77. the SMI, as amended by the extensions specified in [4, 5].
  78.  
  79.  
  80. 4. Overview
  81.  
  82. The Macintosh is a personal computer designed and sold by Apple Computer, 
  83. Inc. It is shipped with built-in networking using Localtalk and/or 
  84. EtherTalk [6] and has the ability to support almost any networking hardware 
  85. [7]. Thus, it is commonly connected into large networks and a method to 
  86. manage these computers on these networks becomes necessary. Since Macintosh 
  87. computers are commonly on multivendor networks that coexist with large IP 
  88. networks, it is natural to use SNMP to provide the network management 
  89. required. This MIB defines managed objects to be used for managing 
  90. Macintosh personal computers on networks using SNMP.
  91.  
  92. 4.1.  Structure of the Macintosh MIB
  93.  
  94. The objects are arranged into the following groups:
  95.  
  96.     - System
  97.         General
  98.         MIBs
  99.         Trap Configuration
  100.     - Software 
  101.         General
  102.         Printer
  103.         System Folder
  104.         Applications
  105.     - Hardware
  106.         General
  107.         Nubus
  108.         SCSI
  109.         Volumes
  110.  
  111. 4.2 The System Group
  112.  
  113. The System Group identifies the Macintosh computer. It identifies what MIBs 
  114. are supported. It also holds a table for trap configuration. Using this 
  115. table, an SNMP management console can configure the Macintosh computer with 
  116. the destination address of a console that wants to receive traps from the 
  117. Macintosh computer.
  118.  
  119. 4.3 The Software Group 
  120.  
  121. The Software Group identifies the versions of software provided with every 
  122. machine. It does this by implementing an SNMP interface to the Gestalt 
  123. Manager [9]. It also identifies the chosen printer. It provides a list of 
  124. files in the System Folder and all of its subfolders. This allows 
  125. management of files that can modify system software. Finally, it provides a 
  126. list of all of the applications on the system. This allows management of 
  127. site-licensed software.
  128.  
  129. 4.4 The Hardware Group
  130.  
  131. The Hardware Group describes the physical parts of the Macintosh computer. 
  132. It lists the hardware ports available. It describes each expansion card 
  133. plugged into the NuBus and each device plugged into the SCSI bus. It also 
  134. lists every mounted volume. It does not contain things that can be 
  135. determined from the Gestalt interface in the Software Group.
  136.  
  137.  
  138. 5. Textual Conventions
  139.  
  140. In the past, there have been misinterpretations of the MIB as to when a 
  141. string of octets should contain printable characters, meant to be 
  142. displayed to a human. As a textual convention in the MIB, the data type 
  143. DisplayString was introduced [2]. A DisplayString is restricted to the NVT 
  144. ASCII character set, as defined in pages 10-11 of [8]. This convention 
  145. is adequate for some countries and some MIBs. The Macintosh is, however, 
  146. sold worldwide and requires that human-readable strings be more flexible 
  147. than the NVT ASCII character set. Therefore, a new data type, 
  148. MacintoshDisplayString ::= OCTET STRING, has been defined. This data type
  149. is interpreted as a string to be displayed to a user and is not limited to 
  150. the NVT ASCII character set. It is instead defined by Appendix D in [6]. 
  151.  
  152. A common type used to name things on the Macintosh is a 32-bit integer 
  153. with each of its four octets consisting of a character (usually NVT ASCII) 
  154. that is used as a human-readable mnemonic. This type is used in the 
  155. Macintosh computer's Resource Manager as well as in the gestaltTable. A new 
  156. data type, MacOSType ::= INTEGER, has been defined. For purposes of display 
  157. only, this data type should be interpreted as four octets of a 
  158. MacintoshDisplayString. 
  159.  
  160. Finally, the Macintosh uses a 32-bit integer to represent a date in the 
  161. file system and many other places. A new data type has been defined, 
  162. MacDate ::= INTEGER, which should be interpreted as the number of seconds 
  163. since midnight, January 1, 1904, and names a particular date and time.
  164.  
  165. It should be noted that these changes have no effect on either the 
  166. syntax or semantics of any objects. The use of these definitions is 
  167. merely an artifact of the explanatory method used in the Macintosh MIB 
  168. and future MIBs.
  169.  
  170. 6. Definitions
  171.  
  172. Apple-Macintosh-System-MIB DEFINITIONS ::= BEGIN
  173.  
  174. IMPORTS
  175.     TRAP-TYPE
  176.         FROM RFC-1215
  177.     DisplayString
  178.         FROM RFC1213-MIB
  179.     OBJECT-TYPE
  180.         FROM RFC-1212
  181.     TimeTicks, enterprises, Counter
  182.         FROM RFC1155-SMI;
  183.  
  184.  
  185. -- Textual Conventions
  186.  
  187. -- MacOSType is an unsigned integer of four octets, which should be 
  188. -- interpreted as four characters to be displayed to a user. 
  189.  
  190.    MacOSType ::= INTEGER
  191.    
  192. -- MacDate is an unsigned integer of four bytes and is the number of 
  193. -- seconds since midnight, January 1, 1904.
  194.  
  195.    MacDate ::= INTEGER
  196.    
  197. -- MacintoshDisplayString is interpreted as a string to be displayed to a 
  198. -- user. 
  199.  
  200.     MacintoshDisplayString ::= OCTET STRING
  201.  
  202. -- Macintosh System MIB
  203.  
  204. apple         OBJECT IDENTIFIER ::= { enterprises 63 }
  205. macintosh     OBJECT IDENTIFIER ::= { apple 1 }
  206. experimental OBJECT IDENTIFIER ::= { apple 2 }
  207.  
  208. -- A user-generated trap
  209.  
  210. userInTrouble  TRAP-TYPE
  211. ENTERPRISE  apple
  212. VARIABLES   { snmpZone, snmpName, helpMsg }
  213. DESCRIPTION
  214. "A userInTrouble trap signifies that the sending SNMP 
  215. application's user is having some trouble using the network and 
  216. wishes to receive help from a knowledgeable network manager."
  217. ::= 0
  218.  
  219.  
  220. -- The Groups
  221.  
  222. system            OBJECT IDENTIFIER ::= { macintosh 1 }
  223. software        OBJECT IDENTIFIER ::= { macintosh 2 }
  224. hardware        OBJECT IDENTIFIER ::= { macintosh 3 }
  225.  
  226.  
  227. -- The System Group
  228.     
  229. snmpName OBJECT-TYPE
  230. SYNTAX MacintoshDisplayString
  231. ACCESS    read-only
  232. STATUS    mandatory
  233. DESCRIPTION
  234. "The name advertised over NBP with type 'SNMP Agent.' The 
  235. default is the same as the machine name set in the Sharing 
  236. Setup Control Panel. If there is no machine name, a random 
  237. unique name will be chosen." 
  238. REFERENCE
  239. "See 'Inside Macintosh' Vol. VI, Ch. 7." 
  240. ::= { system 1 }
  241.  
  242. snmpZone OBJECT-TYPE
  243. SYNTAX    MacintoshDisplayString (SIZE (1..32))
  244. ACCESS    read-only
  245. STATUS    mandatory
  246. DESCRIPTION
  247. "A text string that contains the zone name used to advertise 
  248. over NBP with type 'SNMP Agent.' The default is the local zone 
  249. name of the node."
  250. REFERENCE
  251. "See 'Inside Macintosh' Vol. VI, Ch. 7." 
  252. ::= { system 2 }
  253.  
  254. machineIcon  OBJECT-TYPE
  255. SYNTAX    OCTET STRING (SIZE (128))
  256. ACCESS    read-only
  257. STATUS    mandatory
  258. DESCRIPTION
  259. "A 32 x 32 pixel image of the Macintosh computer. The bits of 
  260. the first four octets are the pixels in right to left order as 
  261. the top row of the image. Ensuing four-octet groups are 
  262. interpreted as descending rows."
  263. REFERENCE
  264. "See 'Inside Macintosh' Vol. VI, Ch. 3."
  265. ::= { system 3 }
  266.  
  267. snmpPhone OBJECT-TYPE
  268. SYNTAX    MacintoshDisplayString (SIZE (1..32 ))
  269. ACCESS    read-only
  270. STATUS    mandatory
  271. DESCRIPTION
  272. "A text string that contains the phone number of a phone near 
  273. the Macintosh computer." 
  274. ::= { system 4 }
  275.  
  276. helpMessage  OBJECT-TYPE
  277. SYNTAX    MacintoshDisplayString (SIZE (1..255))
  278. ACCESS    read-only
  279. STATUS    mandatory
  280. DESCRIPTION
  281. "A text string that contains the message that the user wished 
  282. to send to a network manager." 
  283. ::= { system 5 }
  284.  
  285.  
  286. -- GroupIndex is a unique number assigned to each group registered 
  287.  
  288.     GroupIndex ::= INTEGER
  289.  
  290. -- AgentIndex is a unique number assigned to each agent registered 
  291.  
  292.     AgentIndex ::= INTEGER
  293.  
  294.  
  295. contentsTable  OBJECT-TYPE
  296. SYNTAX     SEQUENCE OF ContentsEntry
  297. ACCESS    not-accessible
  298. STATUS    mandatory
  299. DESCRIPTION
  300. "Contains information about agents and groups of variables 
  301. registered at this node."
  302. ::= { system 6 }
  303.  
  304. contentsEntry  OBJECT-TYPE
  305. SYNTAX     ContentsEntry
  306. ACCESS    not-accessible
  307. STATUS    mandatory
  308. DESCRIPTION
  309. "Each entry contains information about an agent or group that 
  310. has been registered at this node. The indexes are the 
  311. AgentIndex and GroupIndex, which are unique integers assigned 
  312. to each agent and group registered."
  313. INDEX { AgentIndex, GroupIndex }
  314. ::= { contentsTable  1 }
  315.  
  316. ContentsEntry         ::= SEQUENCE {
  317. contentsAgent        MacintoshDisplayString,
  318. contentsGroup        MacintoshDisplayString,
  319. contentsObjectID    OBJECT IDENTIFIER
  320. }
  321.  
  322. contentsAgent  OBJECT-TYPE
  323. SYNTAX     MacintoshDisplayString
  324. ACCESS    read-only
  325. STATUS    mandatory
  326. DESCRIPTION
  327. "The name of the agent owning this group." 
  328. ::= { contentsEntry 1 }
  329.  
  330. contentsGroup  OBJECT-TYPE
  331. SYNTAX     MacintoshDisplayString
  332. ACCESS    read-only
  333. STATUS    mandatory
  334. DESCRIPTION
  335. "The name of the group." 
  336. ::= { contentsEntry 2 }
  337.  
  338. contentsObjectID     OBJECT-TYPE
  339. SYNTAX     OBJECT IDENTIFIER
  340. ACCESS    read-only
  341. STATUS    mandatory
  342. DESCRIPTION
  343. "The object ID of the group."
  344. ::= { contentsEntry 3 }
  345.  
  346. trapTable   OBJECT-TYPE
  347. SYNTAX  SEQUENCE OF TrapRequestEntry
  348. ACCESS  not-accessible
  349. STATUS  mandatory
  350. DESCRIPTION
  351. "Contains a list of all the consoles that traps will be sent 
  352. to."
  353. ::= { system 7 }
  354.  
  355. trapRequestEntry     OBJECT-TYPE
  356. SYNTAX  TrapRequestEntry
  357. ACCESS  not-accessible
  358. STATUS  mandatory
  359. DESCRIPTION
  360. "Each entry contains a complete description of a trap's 
  361. destination." 
  362. INDEX { trapIndex }
  363. ::= { trapTable 1 }
  364.  
  365. TrapRequestEntry     ::= SEQUENCE {
  366. trapIndex        INTEGER,
  367. trapCommunity    MacintoshDisplayString,
  368. trapProtocol    MacintoshDisplayString,
  369. trapDestination    OCTET STRING,
  370. trapValidity    INTEGER
  371. }
  372.  
  373. trapIndex  OBJECT-TYPE
  374. SYNTAX  INTEGER
  375. ACCESS  read-only
  376. STATUS  mandatory
  377. DESCRIPTION
  378. "The index into the trapTable."
  379. ::= { trapRequestEntry 1 }
  380.  
  381. trapCommunity  OBJECT-TYPE
  382. SYNTAX  MacintoshDisplayString
  383. ACCESS  read-write
  384. STATUS  mandatory
  385. DESCRIPTION
  386. "The community that must be associated with the trap."
  387. ::= { trapRequestEntry 2 }
  388.  
  389. trapProtocol  OBJECT-TYPE
  390. SYNTAX  MacintoshDisplayString
  391. ACCESS  read-write
  392. STATUS  mandatory
  393. DESCRIPTION
  394. "The identifier of the protocol that the trap must use. For IP 
  395. this is 'UDP ', for AppleTalk this is 'DDP ', etc." 
  396. REFERENCE
  397. "See 'MacSNMP Programmer's Guide.'" 
  398. ::= { trapRequestEntry 3 }
  399.  
  400. trapDestination  OBJECT-TYPE
  401. SYNTAX  OCTET STRING
  402. ACCESS  read-write
  403. STATUS  mandatory
  404. DESCRIPTION
  405. "Where to send a trap. This information is different for each 
  406. protocol. For TCP/IP the IP address in dotted decimal notation 
  407. is used; for AppleTalk the NBP name of the console is used."
  408. REFERENCE
  409. "See 'MacSNMP Administrator's Guide.'" 
  410. ::= { trapRequestEntry 4 }
  411.  
  412. trapValidity  OBJECT-TYPE
  413. SYNTAX  INTEGER {
  414. valid(1),
  415. invalid(2)
  416. }
  417. ACCESS  read-write
  418. STATUS  mandatory
  419. DESCRIPTION
  420. "This entry defines whether the row is still active and valid."
  421. ::= { trapRequestEntry 5 }
  422.  
  423.  
  424. -- The Software Group
  425.     
  426.     
  427. gestaltTable  OBJECT-TYPE
  428. SYNTAX     SEQUENCE OF GestaltEntry
  429. ACCESS    not-accessible
  430. STATUS    mandatory
  431. DESCRIPTION
  432. "Contains the results from the Gestalt call. Some interesting 
  433. Gestalt selectors are 'ram ' for bytes of physical RAM, 'romv' 
  434. for ROM version, 'sysv' for system version, and 'atlk' for 
  435. AppleTalk version."
  436. REFERENCE
  437. "See 'Inside Macintosh' Vol. VI, Ch. 3."
  438. ::= { software 1 }
  439.  
  440. gestaltEntry  OBJECT-TYPE
  441. SYNTAX     GestaltEntry
  442. ACCESS    not-accessible
  443. STATUS    mandatory
  444. DESCRIPTION
  445. "Each entry contains the Gestalt selector, the response, and 
  446. the response type." 
  447. INDEX { gestaltSelector }
  448. ::= { gestaltTable 1 }
  449.  
  450. GestaltEntry         ::= SEQUENCE {
  451. gestaltSelector        MacOSType,
  452. gestaltResponseType    INTEGER,
  453. gestaltResponse        OCTET STRING (SIZE (4))
  454. }
  455.  
  456. gestaltSelector  OBJECT-TYPE
  457. SYNTAX     MacOSType
  458. ACCESS    read-only
  459. STATUS    mandatory
  460. DESCRIPTION
  461. "A four-octet string that determines what information you want. 
  462. It usually consists of ASCII characters."
  463. ::= { gestaltEntry 1 }
  464.  
  465. gestaltResponseType     OBJECT-TYPE
  466. SYNTAX     INTEGER {
  467.         other(1),
  468.         unknown(2),
  469.         attr(3),
  470.         count(4),
  471.         size(5),
  472.         table(6),
  473.         type(7),
  474.         version(8)
  475. }
  476. ACCESS    read-only
  477. STATUS    mandatory
  478. DESCRIPTION
  479. "How to interpret the Gestalt response: Attr is a bit field; 
  480. Count is how many of the type exist; Size is usually in bytes; 
  481. Table is the memory address of a table; Version is in binary-
  482. coded decimal."
  483. REFERENCE
  484. "See 'Inside Macintosh' Vol. VI, Ch. 3."
  485. ::= { gestaltEntry 2 }
  486.  
  487. gestaltResponse  OBJECT-TYPE
  488. SYNTAX     OCTET STRING (SIZE (4))
  489. ACCESS    read-only
  490. STATUS    mandatory
  491. DESCRIPTION
  492. "The information you requested. Its interpretation depends on 
  493. the corresponding Gestalt type."
  494. ::= { gestaltEntry 3 }
  495.  
  496. printerName  OBJECT-TYPE
  497. SYNTAX     MacintoshDisplayString  (SIZE (0..31))
  498. ACCESS    read-only
  499. STATUS    mandatory
  500. DESCRIPTION
  501. "The name of the printer currently chosen."
  502. ::= { software 2 }
  503.  
  504. printerZone  OBJECT-TYPE
  505. SYNTAX     MacintoshDisplayString (SIZE (0..31))
  506. ACCESS    read-only
  507. STATUS    mandatory
  508. DESCRIPTION
  509. "The zone of the printer currently chosen."
  510. ::= { software 3 }
  511.  
  512. printerType  OBJECT-TYPE
  513. SYNTAX     MacintoshDisplayString (SIZE (0..31))
  514. ACCESS    read-only
  515. STATUS    mandatory
  516. DESCRIPTION
  517. "The name of the printer driver currently chosen."
  518. ::= { software 4 }
  519.  
  520. systemFilesTable      OBJECT-TYPE
  521. SYNTAX     SEQUENCE OF FileEntry
  522. ACCESS    not-accessible
  523. STATUS    mandatory
  524. DESCRIPTION
  525. "Contains a list of all the files in the active System Folder 
  526. and its subfolders."
  527. ::= { software 5 }
  528.  
  529. fileEntry  OBJECT-TYPE
  530. SYNTAX     FileEntry
  531. ACCESS    not-accessible
  532. STATUS    mandatory
  533. DESCRIPTION
  534. "Each entry contains a complete description of a file and its 
  535. location. The index starts at one and increments by one for 
  536. each file." 
  537. INDEX { INTEGER }
  538. ::= { systemFilesTable 1 }
  539.  
  540. FileEntry         ::= SEQUENCE {
  541. fileName        MacintoshDisplayString,
  542. fileCreator        MacOSType,
  543. fileSize        INTEGER,
  544. fileCreateDate     MacDate,
  545. fileModDate        MacDate,
  546. fileVersion        MacintoshDisplayString,
  547. fileDirName        MacintoshDisplayString,
  548. fileType        MacOSType
  549. }
  550.  
  551. fileName  OBJECT-TYPE
  552. SYNTAX     MacintoshDisplayString
  553. ACCESS    read-only
  554. STATUS    mandatory
  555. DESCRIPTION
  556. "The name of the file. The ASCII character for the colon (:) is 
  557. not allowed."
  558. ::= { fileEntry 1 }
  559.  
  560. fileCreator  OBJECT-TYPE
  561. SYNTAX     MacOSType
  562. ACCESS    read-only
  563. STATUS    mandatory
  564. DESCRIPTION
  565. "The creator of the file. A four-character string that is 
  566. usually in ASCII."
  567. ::= { fileEntry 2  }
  568.  
  569. fileSize  OBJECT-TYPE
  570. SYNTAX     INTEGER
  571. ACCESS    read-only
  572. STATUS    mandatory
  573. DESCRIPTION
  574. "The size of the file in bytes."
  575. ::= { fileEntry 3  }
  576.  
  577. fileCreateDate  OBJECT-TYPE
  578. SYNTAX     MacDate
  579. ACCESS    read-only
  580. STATUS    mandatory
  581. DESCRIPTION
  582. "The creation date of the file in seconds from midnight, 
  583. January 1, 1904."
  584. ::= { fileEntry 4  }
  585.  
  586. fileModDate  OBJECT-TYPE
  587. SYNTAX     MacDate
  588. ACCESS    read-only
  589. STATUS    mandatory
  590. DESCRIPTION
  591. "The modification date of the file in seconds from midnight, 
  592. January 1, 1904."
  593. ::= { fileEntry 5  }
  594.  
  595. fileVersion  OBJECT-TYPE
  596. SYNTAX     MacintoshDisplayString
  597. ACCESS    read-only
  598. STATUS    mandatory
  599. DESCRIPTION
  600. "The version of the application."
  601. REFERENCE
  602. "See 'Inside Macintosh' Vol. III, Ch. 1." 
  603. ::= { fileEntry 6  }
  604.  
  605. fileDirName  OBJECT-TYPE
  606. SYNTAX     MacintoshDisplayString
  607. ACCESS    read-only
  608. STATUS    mandatory
  609. DESCRIPTION
  610. "The name of the directory the file is in. The ASCII character 
  611. for the colon (:) is not allowed."
  612. ::= { fileEntry 7 }
  613.  
  614. fileType  OBJECT-TYPE
  615. SYNTAX     MacOSType
  616. ACCESS    read-only
  617. STATUS    mandatory
  618. DESCRIPTION
  619. "The type of the file. A four-character string that is usually 
  620. in ASCII."
  621. ::= { fileEntry 8 }
  622.  
  623. applicationFilesTable        OBJECT-TYPE
  624. SYNTAX     SEQUENCE OF ApplEntry
  625. ACCESS    not-accessible
  626. STATUS    mandatory
  627. DESCRIPTION
  628. "Contains a list of all the applications on the local volumes."
  629. ::= { software 6 }
  630.  
  631. applEntry  OBJECT-TYPE
  632. SYNTAX    ApplEntry
  633. ACCESS    not-accessible
  634. STATUS    mandatory
  635. DESCRIPTION
  636. "Each entry contains a complete description of a file and where 
  637. it is. The second index starts at one and is incremented by one 
  638. for each file. The VolRefNum is from the volumeTable."
  639. INDEX { volRefNum, INTEGER }
  640. ::= { applicationFilesTable 1 }
  641.  
  642. ApplEntry         ::= SEQUENCE {
  643. applName        MacintoshDisplayString,
  644. applCreator        MacOSType,
  645. applSize        INTEGER,
  646. applCreateDate     MacDate,
  647. applModDate        MacDate,
  648. applVersion        MacintoshDisplayString
  649. }
  650.  
  651. applName  OBJECT-TYPE
  652. SYNTAX     MacintoshDisplayString
  653. ACCESS    read-only
  654. STATUS    mandatory
  655. DESCRIPTION
  656. "The name of the application."
  657. ::= { applEntry 1 }
  658.  
  659. applCreator  OBJECT-TYPE
  660. SYNTAX     MacOSType
  661. ACCESS    read-only
  662. STATUS    mandatory
  663. DESCRIPTION
  664. "The creator of the application. A four-character string that 
  665. is usually in ASCII."
  666. ::= { applEntry 2  }
  667.  
  668. applSize  OBJECT-TYPE
  669. SYNTAX     INTEGER
  670. ACCESS    read-only
  671. STATUS    mandatory
  672. DESCRIPTION
  673. "The size of the application in bytes."
  674. ::= { applEntry 3  }
  675.  
  676. applCreateDate  OBJECT-TYPE
  677. SYNTAX     MacDate
  678. ACCESS    read-only
  679. STATUS    mandatory
  680. DESCRIPTION
  681. "The creation date of the application in seconds from midnight, 
  682. January 1, 1904."
  683. ::= { applEntry 4  }
  684.  
  685. applModDate  OBJECT-TYPE
  686. SYNTAX     MacDate
  687. ACCESS    read-only
  688. STATUS    mandatory
  689. DESCRIPTION
  690. "The modification date of the application in seconds from 
  691. midnight, January 1, 1904."
  692. ::= { applEntry 5  }
  693.  
  694. applVersion  OBJECT-TYPE
  695. SYNTAX     MacintoshDisplayString
  696. ACCESS    read-only
  697. STATUS    mandatory
  698. DESCRIPTION
  699. "The version of the application." 
  700. REFERENCE
  701. "See 'Inside Macintosh' Vol. III, Ch.1." 
  702. ::= { applEntry 6  }
  703.  
  704.  
  705. -- The Hardware Group
  706.  
  707. nuBusTable  OBJECT-TYPE
  708. SYNTAX     SEQUENCE OF NuBusEntry
  709. ACCESS    not-accessible
  710. STATUS    mandatory
  711. DESCRIPTION
  712. "Contains a list of all the NuBus cards contained in the 
  713. Macintosh." 
  714. REFERENCE
  715. "NuBus is a trademark of Texas Instruments."
  716. ::= { hardware 1 }
  717.  
  718. nuBusEntry  OBJECT-TYPE
  719. SYNTAX     NuBusEntry
  720. ACCESS    not-accessible
  721. STATUS    mandatory
  722. DESCRIPTION
  723. "Each entry contains a complete description of a NuBus card." 
  724. REFERENCE
  725. "See 'Designing Cards and Drivers for the Macintosh II and the 
  726. Macintosh SE,' Chapter 8, Addison-Wesley Publishing Company, 
  727. Inc., 1987."
  728. INDEX { nuBusSlot}
  729. ::= { nuBusTable 1 }
  730.  
  731. NuBusEntry         ::= SEQUENCE {
  732. nuBusSlot            INTEGER,
  733. nuBusType            INTEGER,
  734. nuBusBoardID        INTEGER,
  735. nuBusBoardName        MacintoshDisplayString,
  736. nuBusVendorName        MacintoshDisplayString,
  737. nuBusPartNumber        MacintoshDisplayString,
  738. nuBusSerialNumber    MacintoshDisplayString,
  739. nuBusRevNumber        MacintoshDisplayString,    
  740. nuBusRevDate        MacintoshDisplayString
  741. }
  742.  
  743. nuBusSlot  OBJECT-TYPE
  744. SYNTAX     INTEGER
  745. ACCESS    read-only
  746. STATUS    mandatory
  747. DESCRIPTION
  748. "The slot number of the board."
  749. ::= { nuBusEntry 1  }
  750.  
  751. nuBusType  OBJECT-TYPE
  752. SYNTAX     INTEGER
  753. ACCESS    read-only
  754. STATUS    mandatory
  755. DESCRIPTION
  756. "The category and cType of the board."
  757. ::= { nuBusEntry 2  }
  758.  
  759. nuBusBoardID     OBJECT-TYPE
  760. SYNTAX     INTEGER
  761. ACCESS    read-only
  762. STATUS    mandatory
  763. DESCRIPTION
  764. "The ID of the board."
  765. ::= { nuBusEntry 3  }
  766.  
  767. nuBusBoardName     OBJECT-TYPE
  768. SYNTAX     MacintoshDisplayString
  769. ACCESS    read-only
  770. STATUS    mandatory
  771. DESCRIPTION
  772. "The name of the board."
  773. ::= { nuBusEntry 4  }
  774.  
  775. nuBusVendorName     OBJECT-TYPE
  776. SYNTAX     MacintoshDisplayString
  777. ACCESS    read-only
  778. STATUS    mandatory
  779. DESCRIPTION
  780. "The name of the vendor."
  781. ::= { nuBusEntry 5  }
  782.  
  783. nuBusPartNumber     OBJECT-TYPE
  784. SYNTAX     MacintoshDisplayString
  785. ACCESS    read-only
  786. STATUS    mandatory
  787. DESCRIPTION
  788. "The part number of the board."
  789. ::= { nuBusEntry 6  }
  790.  
  791. nuBusSerialNumber     OBJECT-TYPE
  792. SYNTAX     MacintoshDisplayString
  793. ACCESS    read-only
  794. STATUS    mandatory
  795. DESCRIPTION
  796. "The serial number of the board."
  797. ::= { nuBusEntry 7  }
  798.  
  799. nuBusRevNumber     OBJECT-TYPE
  800. SYNTAX     MacintoshDisplayString
  801. ACCESS    read-only
  802. STATUS    mandatory
  803. DESCRIPTION
  804. "The revision number of the board."
  805. ::= { nuBusEntry 8  }
  806.  
  807. nuBusRevDate     OBJECT-TYPE
  808. SYNTAX     MacintoshDisplayString
  809. ACCESS    read-only
  810. STATUS    mandatory
  811. DESCRIPTION
  812. "The revision date of the board."
  813. ::= { nuBusEntry 9  }
  814.  
  815. scsiTable  OBJECT-TYPE
  816. SYNTAX     SEQUENCE OF SCSIEntry
  817. ACCESS    not-accessible
  818. STATUS    mandatory
  819. DESCRIPTION
  820. "Contains a list of all the SCSI devices in the Macintosh."
  821. ::= { hardware 2 }
  822.  
  823. scsiEntry   OBJECT-TYPE
  824. SYNTAX     SCSIEntry
  825. ACCESS    not-accessible
  826. STATUS    mandatory
  827. DESCRIPTION
  828. "Each entry contains a complete description of a SCSI device. 
  829. The index is equal to the scsiID + 1." 
  830. INDEX { INTEGER }
  831. ::= { scsiTable 1 }
  832.  
  833. SCSIEntry         ::= SEQUENCE {
  834. scsiID            INTEGER,
  835. scsiType        MacintoshDisplayString,
  836. scsiVendor        MacintoshDisplayString,
  837. scsiProduct        MacintoshDisplayString,
  838. scsiVersion        MacintoshDisplayString
  839. }
  840.  
  841. scsiID OBJECT-TYPE
  842. SYNTAX     INTEGER
  843. ACCESS    read-only
  844. STATUS    mandatory
  845. DESCRIPTION
  846. "The bus ID of the SCSI device."
  847. ::= { scsiEntry 1  }
  848.  
  849. scsiType OBJECT-TYPE
  850. SYNTAX     MacintoshDisplayString
  851. ACCESS    read-only
  852. STATUS    mandatory
  853. DESCRIPTION
  854. "The type of the SCSI device."
  855. ::= { scsiEntry 2  }
  856.  
  857. scsiVendor  OBJECT-TYPE
  858. SYNTAX     MacintoshDisplayString
  859. ACCESS    read-only
  860. STATUS    mandatory
  861. DESCRIPTION
  862. "The vendor of the SCSI device."
  863. ::= { scsiEntry 3  }
  864.  
  865. scsiProduct  OBJECT-TYPE
  866. SYNTAX     MacintoshDisplayString
  867. ACCESS    read-only
  868. STATUS    mandatory
  869. DESCRIPTION
  870. "The product name of the SCSI device."
  871. ::= { scsiEntry 4  }
  872.  
  873. scsiVersion  OBJECT-TYPE
  874. SYNTAX     MacintoshDisplayString
  875. ACCESS    read-only
  876. STATUS    mandatory
  877. DESCRIPTION
  878. "The version of the SCSI device."
  879. ::= { scsiEntry 5  }
  880.  
  881. volumeTable   OBJECT-TYPE
  882. SYNTAX     SEQUENCE OF VolumeEntry
  883. ACCESS    not-accessible
  884. STATUS    mandatory
  885. DESCRIPTION
  886. "Contains a list of all the volumes directly connected to the 
  887. Macintosh."
  888. ::= { hardware 3 }
  889.  
  890. volumeEntry  OBJECT-TYPE
  891. SYNTAX     VolumeEntry
  892. ACCESS    not-accessible
  893. STATUS    mandatory
  894. DESCRIPTION
  895. "Each entry contains a complete description of a volume." 
  896. INDEX { volRefNum }
  897. ::= { volumeTable 1 }
  898.  
  899. VolumeEntry         ::= SEQUENCE {
  900. volRefNum        INTEGER,
  901. volName            MacintoshDisplayString,
  902. volKind            MacintoshDisplayString,
  903. volLocation        MacintoshDisplayString,
  904. volBytesUsed    Counter,
  905. volBytesFree    Counter
  906. }
  907.  
  908. volRefNum  OBJECT-TYPE
  909. SYNTAX     INTEGER
  910. ACCESS    read-only
  911. STATUS    mandatory
  912. DESCRIPTION
  913. "The reference number of the volume. Usually a negative 
  914. number."
  915. ::= { volumeEntry 1  }
  916.  
  917. volName  OBJECT-TYPE
  918. SYNTAX     MacintoshDisplayString
  919. ACCESS    read-only
  920. STATUS    mandatory
  921. DESCRIPTION
  922. "The name of the volume."
  923. ::= { volumeEntry 2  }
  924.  
  925. volKind  OBJECT-TYPE
  926. SYNTAX     MacintoshDisplayString
  927. ACCESS    read-only
  928. STATUS    mandatory
  929. DESCRIPTION
  930. "The kind of volume."
  931. ::= { volumeEntry 3  }
  932.  
  933. volLocation  OBJECT-TYPE
  934. SYNTAX     MacintoshDisplayString
  935. ACCESS    read-only
  936. STATUS    mandatory
  937. DESCRIPTION
  938. "The location of the volume."
  939. ::= { volumeEntry 4  }
  940.  
  941. volBytesUsed  OBJECT-TYPE
  942. SYNTAX     Counter
  943. ACCESS    read-only
  944. STATUS    mandatory
  945. DESCRIPTION
  946. "The number of bytes used on the volume."
  947. ::= { volumeEntry 5  }
  948.  
  949. volBytesFree  OBJECT-TYPE
  950. SYNTAX     Counter
  951. ACCESS    read-only
  952. STATUS    mandatory
  953. DESCRIPTION
  954. "The number of bytes free on the volume."
  955. ::= { volumeEntry 6  }
  956.  
  957. END
  958.  
  959.  
  960. 7. Acknowledgments
  961.  
  962. The Apple-IP Working Group was instrumental in defining this document. 
  963. Their support and work were greatly appreciated.
  964.  
  965.  
  966.  
  967. 8. References
  968.  
  969. [1]  Rose, M.T., and K. McCloghrie, "Structure and Identification of 
  970. Management Information for TCP/IP-Based Internets," Internet 
  971. Working Group Request for Comments 1155, Network Information 
  972. Center, SRI International, Menlo Park, California, May 1990.
  973.  
  974. [2]  McCloghrie, K., and M.T. Rose, "Management Information Base for 
  975. Network Management of TCP/IP-Based Internets," Internet Working 
  976. Group Request for Comments 1213, Network Information Center, SRI 
  977. International, Menlo Park, California, May 1990.
  978.  
  979. [3]  Case, J.D., M.S. Fedor, M.L. Schoffstall, and J.R. Davin, 
  980. "Simple Network Management Protocol," Internet Working Group 
  981. Request for Comments 1157, Network Information Center, SRI 
  982. International, Menlo Park, California, May 1990.
  983.  
  984. [4]  Rose, M.T., and K. McCloghrie, Editors, "Towards Concise MIB 
  985. Definitions," Internet Draft, Internet Engineering Task Force, 
  986. September 1990.
  987.  
  988. [5]  M. Rose, Editor, "A Convention for Defining Traps
  989. for Use With the SNMP," Internet Working Group Request for 
  990. Comments 1158, Network Information Center, SRI International, 
  991. Menlo Park, California, March 1991. 
  992.  
  993. [6]  Sidhu, Gursharan S., Richard F. Andrews, and Alan B. 
  994. Oppenheimer, "Inside AppleTalk," second edition, Addison-Wesley 
  995. Publishing Company, Inc., 1991.
  996.  
  997. [7]  "Apple Multivendor Network Solutions Guide," Apple Computer, 
  998. Inc., 1990.
  999.  
  1000. [8]  Postel, J.B., and J.K. Reynolds, "Telnet Protocol 
  1001. specification," Internet Working Group Request for Comments 854, 
  1002. Network Information Center, SRI International, Menlo Park, 
  1003. California, May 1983.
  1004.  
  1005. [9]  "Inside Macintosh," Volumes I - VI, Addison-Wesley Publishing 
  1006. Company, Inc., 1985-1991.
  1007.  
  1008. 9. Author's address 
  1009.  
  1010. Mike Ritter
  1011. Apple Computer, Inc.
  1012. 10500 North De Anza Boulevard, MS-35K
  1013. Cupertino, California 95014
  1014.  
  1015. Phone:  408-862-8088
  1016. Fax:    408-862-1159
  1017. EMail:  MWRITTER@applelink.apple.com    
  1018.  
  1019. Ritter  IETF Draft: Macintosh System MIB expires 22 July 1993
  1020.